home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-19 / lspsql2.zip / ASITEST.DOC < prev    next >
Text File  |  1992-08-25  |  4KB  |  132 lines
  1.  ****************************************************************************
  2.  
  3.       asitest.doc
  4.       Copyright (C) 1991-1992 by Autodesk, Inc.
  5.          
  6.       Permission to use, copy, modify, and distribute this software 
  7.       for any purpose and without fee is hereby granted, provided 
  8.       that the above copyright notice appears in all copies and that 
  9.       both that copyright notice and this permission notice appear in 
  10.       all supporting documentation.
  11.  
  12.       THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT EXPRESS OR IMPLIED
  13.       WARRANTY.  ALL IMPLIED WARRANTIES OF FITNESS FOR ANY PARTICULAR
  14.       PURPOSE AND OF MERCHANTABILITY ARE HEREBY DISCLAIMED.
  15.  *****************************************************************************
  16.  
  17. ASITEST.LSP is a test program, which is used for testing the AutoLISP-SQL 
  18. interface. Almost every AutoLISP-SQL function is used in this test.
  19.  
  20. To use ASITEST, do the following:
  21.     1. Load LISPSQL.EXP (or LISPSQL under UNIX) with the xload command
  22.        (i.e. (xload "lispsql"))
  23.        If it succeeds, "LISPSQL" will be echoed to the screen.
  24.  
  25.     2. Load ASITEST.LSP with the load command, (i.e. load "asitest").
  26.  
  27. To use the ASITEST commands, specify one of the following commands 
  28. from the command line.
  29.  
  30.     SQLDRV      - Driver Initialisation;
  31.  
  32.     SQLCNC      - Open a Handle to a Database;
  33.  
  34.     SQLDIS      - Release the Connection to a Database;
  35.  
  36.     SQLFILE     - Execute SQL Statements from a file;
  37.  
  38.     SQL         - Execute SQL Statements defined in the dialogue box,
  39.                   and Fetching the results of 'cursor' commands;
  40.  
  41.     TESTBIND    - Execute SQL Statements with Host Variables;
  42.  
  43.     SQLTERM     - Release the Driver.
  44.  
  45.  
  46. SQLDRV 
  47.  
  48.     This command is used to initialize the connection between ASITEST
  49.     and the Driver.  The driver name will be specified as an answer to 
  50.     an inquiry by the program.
  51.  
  52.     Enter SQL driver name:
  53.  
  54.     If the function succeeded, the message "Driver loaded" will be echoed
  55.     to the screen.
  56.  
  57. SQLCNC
  58.  
  59.     This command is used to connect to the database. The database name,
  60.     user name and password are all entered as responses to questions by
  61.     the program.
  62.  
  63.     Database name ->
  64.     User name ->
  65.     Password ->
  66.  
  67.     If the command succeeds, the message "O'k" will be echoed to the screen.
  68.  
  69. SQLDIS 
  70.  
  71.     This command is used to release the connection to the current database.
  72.  
  73. SQLFILE
  74.  
  75.     This command is used to execute SQL statements from a file.
  76.     The file name will be specified when prompted by the program.
  77.     
  78.     For Example:
  79.  
  80.     Enter file name:
  81.  
  82.     The following conventions must be adhered to when creating the SQL
  83.     command file.
  84.  
  85.     1. A string with the symbol '$' in the first column is considered
  86.        to be a comment.
  87.     2. To continue an SQL statement to the next line, the last symbol on the
  88.        previous line must be the '&' character. 
  89.     
  90. SQL  
  91.  
  92.     This command is used to execute SQL statements that are entered on the
  93.     command line.  And for fetching the results of cursor commands.  
  94.  
  95.     SQL STATEMENT.
  96.     drvname\basename\username>
  97.  
  98.     If a 'cursor' command is detected, the following fetch commands are 
  99.     available.
  100.  
  101.     First       - Fetch the First Row.
  102.     Last        - Fetch the Last Row.
  103.     Next        - Fetch in a Forward Direction.
  104.     Previous    - Fetch in a Backward Direction.
  105.     Delete      - Delete Current Row.
  106.     Update      - Update Current row.
  107.     Show        - Print all Row Set.
  108.     Exit        - Exit from Fetching.
  109.  
  110. TESTBIND
  111.  
  112.     This command is used to compile an SQL statement with a host variable.
  113.     It will define the value, type and length of every host variable, and
  114.     execute the compiled SQL statement.  
  115.     
  116.     For example:
  117.  
  118.     SQL STATEMENT>
  119.  
  120.     One can indicate the host variables by using ':'.
  121.  
  122.     Host variable name: 
  123.     Variable type Char/Int/Real/Short/Long/Float:
  124.     Enter host variable value: 
  125.  
  126.     If a cursor command is detected then the fetch commands are available.
  127.  
  128. SQLTERM 
  129.  
  130.     This command is used to release the current driver.
  131.  
  132.